插入以下宏可以设置你要使用的页面。 这些页面将会按你在脚本中插入的顺序出现。你也可以在这些宏之间插入自定义的页面命令以添加自定义页面。
当你使用 "Start Menu Folder" 宏时, 你将需要 "Start Menu Folder" 页面的页面 ID 。 "Start Menu Folder" 将会被保存于指定的变量中。
页面设置应用于单个页面且应在插入一个宏之前设置。如果你有一种类型的多个页面,并且你想要为它们全体作同一个设置,那么请在每个页面宏之前进行设置。 范例:
;添加一个让用户指定插件文件夹的目录页面
;将此文件夹路径存于 $PLUGINS_FOLDER
Var PLUGINS_FOLDER
!define MUI_DIRECTORYPAGE_VARIABLE $PluginsFolder
!insertmacro MUI_PAGE_DIRECTORY
用户界面中所有的标准文字都是由语言文件中载入的, 它们对 NSIS 所支持的所有语言中都有效。因此如果需要进行更改,你仅需要重新定义它们就可以了。
如果某参数是文字的,并且在各语言中并不一样,用 LangString 定义 “语言字符串”,并用 $(LangStringName) 作为它的值。至于在多语言中的许可文本,则用 LicenseLangString 。查阅 NSIS 用户手册可得到有关多语言安装程序的更详细的内容。
在所有的文本设置中,双引号字符(")应该转换成以下格式: $\" 避免出错。
常规页面设置
MUI_PAGE_HEADER_TEXT text
显示于页面页眉的文本。
MUI_PAGE_HEADER_SUBTEXT text
显示于页面页眉的旁白。
欢迎页面设置
要在以下文本中添加新行,使用 \r\n 代替 $\r$\n 。
MUI_WELCOMEPAGE_TITLE title
显示于页面顶部的标题。
MUI_WELCOMEPAGE_TITLE_3LINES
标题区域的额外空区。
MUI_WELCOMEPAGE_TEXT text
显示于页面的文本。
许可页面设置
MUI_LICENSEPAGE_TEXT_TOP text
显示于页面顶部的文本。
MUI_LICENSEPAGE_TEXT_BOTTOM text
显示于页面底部的文本。
MUI_LICENSEPAGE_BUTTON button_text
显示于 “我同意” 按钮的文本。
MUI_LICENSEPAGE_CHECKBOX
显示一个用于用户选中同意许可条款的复选框。
MUI_LICENSEPAGE_CHECKBOX_TEXT text
显示在一个用于用户选中同意许可条款的复选框旁的文本。
MUI_LICENSEPAGE_RADIOBUTTONS
显示两个用于用户是否接受许可条款的单选按钮。
MUI_LICENSEPAGE_RADIOBUTTONS_TEXT_ACCEPT text
显示在用于用户接受许可条款的单选按钮旁的文本。
MUI_LICENSEPAGE_RADIOBUTTONS_TEXT_DECLINE text
显示在用于用户拒绝许可条款的单选按钮旁的文本。
组件页面设置
MUI_COMPONENTSPAGE_TEXT_TOP text
显示于页面顶部的文本。
MUI_COMPONENTSPAGE_TEXT_COMPLIST text
显示在组件列表旁的文本。
MUI_COMPONENTSPAGE_TEXT_INSTTYPE text
显示在安装类型组合框旁的文本。
MUI_COMPONENTSPAGE_TEXT_DESCRIPTION_TITLE text
显示在描述框标题上的文本。
MUI_COMPONENTSPAGE_TEXT_DESCRIPTION_INFO text
当没有选择区段时,显示于描述框中的文本。
目录页面设置
MUI_DIRECTORYPAGE_TEXT_TOP text
显示于页面顶部的文本。
MUI_DIRECTORYPAGE_TEXT_DESTINATION text
显示于目标文件夹框架的文本。
MUI_DIRECTORYPAGE_VARIABLE variable
用于存储所选文件夹的变量。
默认: $INSTDIR
MUI_DIRECTORYPAGE_VERIFYONLEAVE
当一个文件夹无效时, 不禁用 “下一步” 按钮, 但是允许你使用 GetInstDirError 函数以操作一个无效的文件夹。
开始菜单文件夹页面设置
MUI_STARTMENUPAGE_TEXT_TOP text
显示于页面顶部的文本。
MUI_STARTMENUPAGE_TEXT_CHECKBOX text
显示于 “禁止创建开始菜单文件夹” 复选框旁的文本。
MUI_STARTMENUPAGE_DEFAULTFOLDER folder
默认开始菜单文件夹。
MUI_STARTMENUPAGE_NODISABLE
不显示 “禁止创建开始菜单文件夹” 复选框。
MUI_STARTMENUPAGE_REGISTRY_ROOT root
MUI_STARTMENUPAGE_REGISTRY_KEY key
MUI_STARTMENUPAGE_REGISTRY_VALUENAME value_name
此注册表项用于存放开始菜单文件夹路径。 此页面将会用它记住用户的首选项。 你也可以将其用于卸载程序移除此开始菜单文件夹。 不要在卸载时忘记移除此注册表项。
对于卸载程序, 可以用宏 MUI_STARTMENU_GETFOLDER 获取开始菜单文件夹路径:
!insertmacro MUI_STARTMENU_GETFOLDER page_id $R0
Delete "$SMPROGRAMS\$R0\Your Shortcut.lnk"
安装页面设置
MUI_INSTFILESPAGE_FINISHHEADER_TEXT text
当安装完成后, 显示于此安装页面页眉的标题(当使用一个未用 MUI_(UN)FINISHPAGE_NOAUTOCLOSE 的完成页面时, 将不会显示这些文本)。
MUI_INSTFILESPAGE_FINISHHEADER_SUBTEXT text
当安装完成后, 显示于此安装页面页眉的副标题(当使用一个未用 MUI_(UN)FINISHPAGE_NOAUTOCLOSE 的完成页面时, 将不会显示这些文本)。
MUI_INSTFILESPAGE_ABORTHEADER_TEXT text
当安装被终止后,显示于此安装页面页眉的标题。
MUI_INSTFILESPAGE_ABORTHEADER_SUBTEXT text
当安装被终止后,显示于此安装页面页眉的副标题。
been aborted.
完成页面设置
要在以下文本中添加新行,使用 \r\n 代替 $\r$\n 。
MUI_FINISHPAGE_TITLE title
显示于页面顶部的标题。
MUI_FINISHPAGE_TITLE_3LINES
标题区域的额外空区。
MUI_FINISHPAGE_TEXT text
显示于此页面的文本。
MUI_FINISHPAGE_TEXT_LARGE
文本区域的额外空区 (如果使用了复选框)。
MUI_FINISHPAGE_BUTTON text
显示于 “完成” 按钮的文本。
MUI_FINISHPAGE_CANCEL_ENABLED
启用 “取消” 按钮,用户可以点击跳过完成页面显示的任何选项。
page.
MUI_FINISHPAGE_TEXT_REBOOT text
当询问是否重启时,显示于完成页面的文本。
MUI_FINISHPAGE_TEXT_REBOOTNOW text
显示在 “现在重启” 选择按钮旁的文本。
MUI_FINISHPAGE_TEXT_REBOOTLATER text
显示在 “以后重启”" 选择按钮旁的文本。
MUI_FINISHPAGE_REBOOTLATER_DEFAULT
设置 “以后重启” 作为默认选项。
MUI_FINISHPAGE_RUN exe_file
可以通过复选框决定是否运行的应用程序。 当文件名中有空格时,你不需用引号将其括起来。
MUI_FINISHPAGE_RUN_TEXT text
显示在 “运行程序” 复选框旁的文本。
MUI_FINISHPAGE_RUN_PARAMETERS parameters
运行应用程序所需的参数。不要在值中直接使用双引号 (用 $\")。
MUI_FINISHPAGE_RUN_NOTCHECKED
默认不选中 “运行程序” 复选框。
MUI_FINISHPAGE_RUN_FUNCTION function
用调用一个函数替代执行一个应用程序 (定义 MUI_FINISHPAGE_RUN 而不用参数)。 你可以用这个函数执行多个应用程序,或者你可以更改此复选框的名称并用它做其它事情。
MUI_FINISHPAGE_SHOWREADME file/url
可以通过复选框决定是否查看的文件或网站。当文件名中有空格时,你不需用引号将其括起来。
MUI_FINISHPAGE_SHOWREADME_TEXT text
显示在 “显示自述” 复选框旁的文本。
MUI_FINISHPAGE_SHOWREADME_NOTCHECKED
默认不选中 “显示自述” 复选框。
MUI_FINISHPAGE_SHOWREADME_FUNCTION function
用调用一个函数替代显示一个文件 (定义 MUI_FINISHPAGE_SHOWREADME 而不用参数)。 你可以用这个函数显示多个文件,或者你可以更改此复选框的名称并用它做其它事情。
MUI_FINISHPAGE_LINK link_text
一个用于用户点击查看一个网站或文件的链接的文本。
MUI_FINISHPAGE_LINK_LOCATION file/url
可以通过这个链接查看的网站或文件的位置。 当文件名中有空格时, 你不需用引号将其括起来。
MUI_FINISHPAGE_LINK_COLOR (color: RRGGBB hexadecimal)
完成页面上的链接的文本颜色。
默认: 000080
MUI_FINISHPAGE_NOREBOOTSUPPORT
禁用支持此页面允许用户重新启动其系统。 如果不使用 /REBOOTOK 位标计或 SetRebootFlag , 那么定义此选项可以节省一些空间。
卸载确认页面设置
MUI_UNCONFIRMPAGE_TEXT_TOP text
显示于页面顶部的文本。
MUI_UNCONFIRMPAGE_TEXT_LOCATION text
显示在卸载位置文本框旁的文本。
MUI_UNCONFIRMPAGE_VARIABLE variable
用于存储卸载源文件夹的变量。
默认:$INSTDIR